Name

fbpoint — point at and identify screen coordinates

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 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.