FBPOINT(1)

NAME
fbpoint - point at and identify screen coordinates

SYNOPSIS

fbpoint [-F framebuffer] [-w width] [-n height] [-s squaresize] [-x [prefix]] [-y [prefix]] [initialx initialy]

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 optional initialx initialy 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 directions 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.

Using this program with grave accents in a shell script in order to interactively grab a pair of coordinates is one of its 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.

EXAMPLES

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

allows you to select an x, y screen coordinate location and then place the lower left corner of the image file.pix there.

SEE ALSO

brlcad(1), fbgrid(1), fbzoom(1)

AUTHOR

BRL-CAD Team

COPYRIGHT

This software is Copyright (c) 1986-2021 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