Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
_GetImage... Procedures
◄Summary► ◄Details► ◄Example► ◄Back►
Arguments
x1, y1 View coordinates of upper-left corner of bounding
rectangle
x2, y2 View coordinates of lower-right corner of bounding
rectangle
wx1, wy1 Window coordinates of upper-left corner of bounding
rectangle
wx2, wy2 Window coordinates of lower-right corner of bounding
rectangle
wxy1, wxy2 Window coordinates of bounding rectangle
image Buffer to hold screen image
Description
The _GetImage procedures store a screen image defined by a
specified bounding rectangle in the buffer associated with that
image. The rectangle must be completely within the current clipping
region.
The buffer must be large enough to hold the image. You must
determine the size by calling the appropriate _ImageSize
function at run time, or by using the formula described in the
_ImageSize help topic.
Warning: The size of buffer required may exceed 64K. No
internal error checking is performed, so any attempt to use
_GetImage without a sufficiently large buffer may alter the
contents of memory.
_GrStatus Returns
_GrError, _GrNotInProperMode, _GrParameterAltered