Graphics Functions: Save an image from a specified portion of the screen into a Windows bitmap file.
Module: USE IFQWIN
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 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.
Compatibility
STANDARD GRAPHICS QUICKWIN GRAPHICS LIB
See Also
GETIMAGE, GETIMAGE_W, IMAGESIZE, IMAGESIZE_W, LOADIMAGE, LOADIMAGE_W, PUTIMAGE, PUTIMAGE_W, Building Applications: Loading and Saving Images to Files