resimg(1X)
NAME
resimg - restore image
SYNTAX
resimg [ options ] [ image ] [ geometry ] [ display ]
ARGUMENTS
image Specifies the name of the image file resimg restores. If not specified, resimg uses stdin.
geometry Specifies the width, length, and location of the window that contains the restored image. If the geometry argument is not specified, resimg 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 window’s horizontal dimension.
lengthSpecifies the number of pixels of the window’s vertical dimension.
xSpecifies the x screen coordinate (pixel value) for the starting corner of the window.
ySpecifies the y screen coordinate (pixel value) for the starting corner of the window.
If the width and length are not specified, the window is the size of the restored image.
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 window is displayed at +0+0. For information about the screen coordinate system, see X(.).
display Specifies the display screen on which the image is displayed. If display is not specified, resimg 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 resimg command restores an image to the screen. The image, previously saved by the savimg command, is restored in a window whose size and location is specified with the geometry argument. If the geometry argument is not specified, the window can be positioned with the mouse pointer and sized with one of the mouse buttons, as follows:
LeftRestores the image to the entire screen.
MiddleRestores the image to an area specifed by mouse movement.
RightRestores the image to an area the size of the window that contains the mouse pointer.
As restored, the image is displayed starting in the upper left corner of the specified window. If the specified window is larger than the image, the remaining window space is displayed in its background color. If the specified window is smaller than the image, the portions of the image beyond the window are clipped. Once created, the window can be exposed, moved, resized, and iconified with the window manager.
OPTIONS
−cm Runs the color manager. The color manager lets the active window on screen access the entire colormap.
−d Directs debugging messages to stderr.
−help Displays resimg options.
−nc Suppresses restoration of the color map. If not specified, the saved colors are displayed.
−o Restores the image at the screen location it occupied when it was saved. If not specified, the location of the image is specified by the geometry argument. If the geometry argument is not specified, the location of the image is specified with the mouse.
−O Restores the image using offscreen memory instead of processing memory. This option, which is supported only for the VAXstation II/GPX, provides instantaneous refresh of an exposed or resized image. If sufficient offscreen memory is not available, then the image uses processor memory.
−sRestores the image to the upper left corner of the screen. If not specified, the location of the image is specified by the geometry argument. If the geometry argument is not specified, the location of the restored image is specified with the mouse.
RESTRICTIONS
Image files saved on the VAXstation II cannot be restored to the VAXstation II/GPX.
EXAMPLES
resimg image1 &
This command, running in the background, restores image1 to a window whose location and size is specified with a mouse.
resimg -s -d image1 -nc atlantis:0 &
This command, running in the background, restores image1 to the upper left corner of the screen of video display 0 on host atlantis without using the color map, and redirects debugging messages to stderr.
resimg =680x234-300-100 < image1 &
This command, running in the background, restores image1 to a window 680 pixels wide and 234 pixels long, whose lower right corner is 300 pixels from the right and 100 pixels from the bottom of the screen.
resimg =x234-300 image1 &
This command, running in the background, restores image1 to a window as wide in pixels as the image and 234 pixels long, whose upper right corner is 300 pixels from the right and 0 pixels from the top of the screen.
FILES
/usr/include/imghdr.h Defines the image file format.