snap(1L)

NAME
snap - capture a portion of the display as a bitmap image

SYNOPSIS
snap [ -n ] <file>

DESCRIPTION
Snap lets a user capture a bit image of an arbitrary rectangular portion of the display. This image may be saved in a file, send to a printer, or copied back to the display.

When snap is active, the user may sweep out an image with the 3rd mouse button. Upon releasing the button, this image is captured and remembered by Snap. The middle button pops-up a menu with the following options:

Print
    The image snapped is sent to the printer (via lpr ) in MGR bitmap format with the -v flag set. If the PRINTER environment variable is set, it is used to specify the printer name, otherwise the image is sent to lp .

File
    The last image snapped is saved in the file specified on the command line when snap was invoked, in MGR bitmap format. Successive invocations of file overwrite any previously stored images.

Review
    Once Review is selected, The user may sweep out (using the 3rd mouse button, as before) an area on which to display the snapped image. If nothing is swept within 10 seconds, snap flashes, rings the bell, and reverts to capture mode. While reviewing in enabled, the snap icon remains inverse video. The displayed image is clipped to fit within the region swept out by the user. If the user simply clicks the 3rd mouse button twice without sweeping, snap copies the entire saved image to the display, starting at the mouse location.

Quit
    Snap de-iconifies itself and quits.

When -n is specified on the command line, the new (8 byte header) style bitmap format is produced, instead of the old (6 byte header) format.

FILES
/dev/bwtwo0
    to find the display image.

SEE ALSO
lpr(1) window_print(1L)

DIAGNOSTICS

*   Can't find screen The frame buffer won't open.

*   Can't open file The file can't be opened for writing.

BUGS

*   The user interface is overly simplistic.

*   snap only works on the mgr host.

*   The review function can write on the display arbitrarily, destroying its integrity.

AUTHOR
S. A. Uhler