# SAVEIMAGE, SAVEIMAGE_W (W*S)

Graphics Functions: Save an image from a specified portion of the screen into a Windows bitmap file.

## Module

USE IFQWIN

result = SAVEIMAGE (filename,ulxcoord,ulycoord, lrxcoord,lrycoord)

result = SAVEIMAGE_W (filename,ulwxcoord,ulwycoord, lrwxcoord,lrwycoord)

filename | (Input) Character*(*). Path of the bitmap file.
ulxcoord, ulycoord | (Input) INTEGER(4). Viewport coordinates for upper-left corner of the screen image to be captured.
lrxcoord, lrycoord | (Input) INTEGER(4). Viewport coordinates for lower-right corner of the screen image to be captured.
ulwxcoord, ulwycoord | (Input) REAL(8). Window coordinates for upper-left corner of the screen image to be captured.
lrwxcoord, lrwycoord | (Input) REAL(8). Window coordinates for lower-right corner of the screen image to be captured.

## Results

The result type is INTEGER(4). The result is zero if successful; otherwise, a negative value.

The SAVEIMAGE function captures the screen image within a rectangle defined by the upper-left and lower-right screen coordinates and stores the image as a Windows bitmap file specified by filename. The image is stored with a palette containing the colors displayed on the screen.

SAVEIMAGE defines the bounding rectangle in viewport coordinates. SAVEIMAGE_W defines the bounding rectangle in window coordinates.

Parent topic: Graphics Library Routines

## See Also

GETIMAGE, GETIMAGE_W
IMAGESIZE, IMAGESIZE_W
LOADIMAGE, LOADIMAGE_W
PUTIMAGE, PUTIMAGE_W