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.   (See
     "gsrsav.")

     The relevant attributes are:

     o   Plane mask
     o   Logical operation.

     Parameters

     buffer            Indicates  where gsrrst  should restore
                       the block of pixels from.

     x1, y1            Define  the  coordiantes 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.

     The intended purpose of the gsrsav and gsrrst subroutines
     is efficient  saving and  restoring of pixel  blocks dis-

     played  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 pos-
     sible to use  gsrsav and gsrrst to  correctly move blocks
     of pixels  from one position  to another in a  plane ori-
     ented 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."