Platform

Win32, x64

Purpose

To copy screen blocks in drawing surfaces defined by %gr (Graphics Region) etc..

Syntax

 INTEGER FUNCTION COPY_GRAPHICS_REGION@(
+ DEST_GR, DX, DY, DWIDTH, DHEIGHT,
+ SRC_GR,  SX, SY, SWIDTH, SHEIGHT, COPY_MODE )
 INTEGER DEST_GR, DX, DY, DWIDTH, DHEIGHT,
+ SRC_GR, SX, SY, SWIDTH, SHEIGHT, COPY_MODE

Description

You must have at least one drawing surface open (see for example %`gr in Graphics format). DEST_GR is the user identifier of the destination drawing surface and SRC_GR is the source drawing surface, however, the identifiers specified can be the same. If you set either or both to zero then the current drawing surface is assumed for the source and/or destination.

DX, DY, DWIDTH and DHEIGHT specify the destination rectangular region.

SX, SY, SWIDTH and SHEIGHT specify the source rectangular region.

If DWIDTH = SWIDTH and DHEIGHT = SHEIGHT then a normal copy will occur. If there are any differences then the image will be 'stretched' accordingly.

COPY_MODE defines the method of copying. Windows defines 255 different copy methods (ROPS). The most useful are described below:

Return value

Returns 1 for success or zero for failure.

Notes

Under Win32 it is possible to stretch a drawing surface when copying from the screen to a printer but not every printer supports this mode.

See also

SCROLL_GRAPHICS@, SELECT_GRAPHICS_OBJECT@, CREATE_GRAPHICS_REGION@, NEW_GRAPHICS_REGION@, DELETE_GRAPHICS_REGION@