savimg(1X)

NAME

savimg - save screen image

SYNTAX

savimg [ options ] image [ geometry ] [ display ]

ARGUMENTS

image Specifies the name of the file in which savimg places the image.

geometry Specifies the width, length, and location of the saved image. If the geometry argument is not specified, savimg uses mouse input. For further information, see DESCRIPTION.

The geometry argument has the format =[width][xlength][x][y].

widthSpecifies the number of pixels of the image’s horizontal dimension.

lengthSpecifies the number of pixels of the image’s vertical dimension.

xSpecifies the x screen coordinate (pixel value) for the starting corner of the image.

ySpecifies the y screen coordinate (pixel value) for the starting corner of the image.

If the width and length are not specified, the window spans the remainder of the screen.

Depending on which corner of the screen each is relative to, the x and y coordinates must be preceded by a plus (+) or a minus (−). If x and y are not specified, the image starts at +0+0. For more information about the screen coordinate system, see X(.).

display Specifies the display screen from which the image is saved. If display is not specified, savimg uses the display screen specified by your DISPLAY environment variable. The display argument has the format hostname:number.

hostnameSpecifies the name of the host machine on which the display is connected. You can specify the name local to use shared memory, the name unix to use UNIX IPC, or the name of your host machine to use TCP.

numberSpecifies the number of the display on that host machine.

DESCRIPTION

The savimg command saves the rectangular area of the screen specified by the geometry argument. If the geometry argument is not specified, the geometry of the image can be specified with one of the mouse buttons, as follows:

LeftSaves the entire screen.

MiddleSaves the area specifed by mouse movement.

RightSaves the window that contains the mouse pointer.

OPTIONS

−a Saves the entire screen. If not specified, uses geometry or mouse input.

−d Directs debugging messages to stderr.

−help Displays savimg options.

−i Inserts a quoted string into the information section of the image file.

−nb Saves the window specified with the −w option without its border.

−nf Allows the screen to update and change while the image is being saved.

−w x y Saves the image of the window that contains the specified x and y coordinates (computed without the window border). The x and y coordinates are positive or negative integer pixel values, depending on their offset from each corner of the screen. If not specified, uses the geometry argument. If the geometry argument is not specified, savimg uses mouse input.

RESTRICTIONS

Image files saved on the VAXstation II cannot be restored to the VAXstation II/GPX.

Image files approach 1 megabyte in size for full screen on a VAXstation II/GPX.

Use of the −nf option is not recommended, due to unpredictable image processing.

EXAMPLES

savimg image1

This command saves an area specified with the mouse in a file named image1.

savimg -a -d image2 -i "starry sky" atlantis:0 -nf

This command saves the entire screen of atlantis (display 0) in image2, outputs any debugging messages to standard error, inserts "starry sky" into the information section of image2, and allows the screen on atlantis to be updated while the image is saved.

savimg =680x234-300-100 >image3

This command saves a rectangle 680 pixels wide and 234 pixels long, whose lower right corner is 300 pixels from the right and 100 pixels from the bottom. The image is saved in image3.

savimg =x234-300 image4

This command saves an image as wide as the screen and 234 pixels long, whose upper right corner is 300 pixels from the right and 0 pixels from the top. The image is saved in a file named image4.

savimg image5 -w+410-345 -nb

This command saves a window (without its border) that contains the specified coordinates. The image is saved in a file named image5.

FILES

/usr/include/imghdr.h Defines the image file format.

Museum