## Name

pl-fb — display 3-D UNIX plot on a framebuffer

## Synopsis

`pl-fb` [-hoid ] [-t `line_thickness`] [-F `framebuffer`] [-S `squaresize`] [-W `width`] [-N `height`] [`file.plot`]

## DESCRIPTION

Pl-fb displays a BRL extended three dimensional UNIX plot file on a framebuffer. The environment variable `FB_FILE` is used to select the display device (see brlcad(1)). If this variable is not set, the default device for your system will be used. By default, the display size is assumed to be 512x512 pixels. Specifying the `-h` flag, changes the output size to 1024x1024. The `-SÂ` `squaresize` `-WÂ` `width` and `-NÂ` `height` flags allow different screen sizes to be set. The plotting space will fill the given screen dimensions. No attempt is made at present to preserve aspect.

The `-o` flag is for overlay mode, where the current framebuffer image will be left in the background. The `-i` flag causes the rasterized image to be plotted immediately, rather than buffering up rasterized data into bands. While useful for quick feedback on small plots, this mode is generally more expensive in CPU time. The `-d` flag outputs a very verbose debugging stream to standard error listing every UNIX plot command and the corresponding framebuffer coordinates. The `-t` flag causes all lines to be thickened perpendicular to their length, to the given number of pixels. This is especially useful when making images for recording on videotape, as single pixel lines are difficult to resolve. The thickening will be reduced so that a line will never be wider than it is long.

If file.plot is not specified, the plot commands are read from standard in.

Note that 3-D UNIX plot is a superset of the standard UNIX plot format, thus this program can display normal plot files as well.

## SEE ALSO

pl-sgi(1), plrot(1), pldebug(1), libplot3(3), brlcad(1).

## AUTHOR

BRL-CAD Team

## COPYRIGHT

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