SAVEIMAGE, SAVEIMAGE_W

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

Module: USE DFLIB

Syntax

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 is of type 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.

Compatibility

STANDARD GRAPHICS QUICKWIN GRAPHICS LIB

See Also: GETIMAGE, GETIMAGE_W, IMAGESIZE, IMAGESIZE_W, LOADIMAGE, LOADIMAGE_W, PUTIMAGE, PUTIMAGE_W