FBPOINT(1)

NAME
fbpoint - point at and identify screen coordinates

SYNOPSIS
fbpoint [-h] [-x[prefix]] [-y[prefix]] [initx inity]

DESCRIPTION
Fbpoint allows you to move a non-destructive cursor around on the display. As the cursor is moved around, fbpoint writes the coordinates of the pixel pointed at by the cursor, and the red, green, and blue values of that pixel, on standard error fbpoint also writes the last set of coordinates pointed to on standard out on exit. The starting position is center-screen unless an optional initx inity is given.

The ``h'', ``j'', ``k'', and ``l'', commands step the cursor one pixel left, down, up, or right respectively, and the ``H'', ``J'', ``K'', and ``L'', commands step the cursor in the corresponding direction in big increments. The ``B'', ``N'', ``P''. and ``L'', and ``^B'', (control-B), ``^N'', ``^P'', and ``^F'', are also little and big (respectively) cursor movement commands.

A ``?'' prints a short command summary, and typing ``q'', or ``Q'', exits the program.

The -h flag causes the frame buffer to be used in high resolution mode (1024x1024). This is important for frame buffers such as the Adage which operate differently depending on the display size. Without this flag the default size for the selected device will be used (usually the entire screen).

Using this program with grave accents in a shell script in order to interactively grab a pair of coordinates is one of it's main intentions. This is the reason for the feedback on standard error and the final coordinate pair on standard out. By default, both the x and y coordinates are written. If the -x or -y flags are given only those coordinates will be written. In these cases an optional prefix can follow the flag which will be appended to the output coordinate. This is to facilitate passing the output of this program as arguments to another.

EXAMPLE
fbpoint
by itself is used to pick coordinates or pixel values from a display.

fbscanplot `fbpoint -y`
allows you to choose the scanline to plot using fbpoint.

pix-fb `fbpoint -x-X -y-Y` file.pix
will allow you to select an x, y screen coordinate and then place the lower left corner of the image file.pix at that location.

SEE ALSO
brlcad(1), fbgrid(1), fbzoom(1)

AUTHORS
Michael John Muuss
J. Robert Suckling

SOURCE
SECAD/VLD Computing Consortium, Bldg 394
The U. S. Army Ballistic Research Laboratory
Aberdeen Proving Ground, Maryland 21005

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