GSRRST(3g,L)                AIX Technical Reference                GSRRST(3g,L)



-------------------------------------------------------------------------------
gsrrst



PURPOSE

Restores a rectangular block.

C SYNTAX

int gsrrst_ (buffer, x1,
y1, x2, y2)

int *buffer, *x1, *y1, *x2, *y2;

FORTRAN SYNTAX

INTEGER function gsrrst (buffer, x1, y1, x2, y2)

INTEGER buffer (*), x1, y1, x2, y2

PASCAL SYNTAX

FUNCTION gsrrst_ (

VAR buffer: ARRAY [1..k] of INTEGER;
VAR x1, y1, x2, y2: INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gsrrst subroutine restores a block of pixels saved to the frame buffer by
the gsrsav subroutine.

The relevant attributes are:

  o Plane mask
  o Logical operation.

Parameters

buffer            Indicates where gsrrst should restore the block of pixels
                  from.  This stored block of pixels is typically a buffer
                  saved in the gsrsav subroutine.

x1, y1            Define the coordinates of the lower left corner of the
                  rectangular area to restore.

x2, y2            Define the coordinates of the upper-right corner of the
                  rectangular area to restore.




Processed November 7, 1990       GSRRST(3g,L)                                 1






GSRRST(3g,L)                AIX Technical Reference                GSRRST(3g,L)



The intended purpose of the gsrsav and gsrrst subroutines is efficient saving
and restoring of pixel blocks displayed temporarily at a fixed location in the
frame buffer.  Because the GSL saves the frame buffer contents in a
device-dependent fashion, it is generally not possible to use gsrsav and gsrrst
to correctly move blocks of pixels from one position to another in a plane
oriented adapter, nor is it possible for the application to manipulate the
buffer without careful consideration of adapter characteristics, block size,
and position of the block in the frame buffer.

For further information on moving and storing blocks of pixels, see "gsxblt."

For Pascal, the application must declare the array passed as being fixed length
and declare the routine as accepting an array of that length.  The k in the
routine declaration must be a constant.

RETURN VALUE

GS_SUCC  Successful.
GS_CORD  Invalid coordinate.
GS_INAC  Virtual terminal inactive.

RELATED INFORMATION

In this book:  "gsrsav" and "gsxblt."































Processed November 7, 1990       GSRRST(3g,L)                                 2