Click above to get retro games delivered to your door ever month!

 savearea()          Save screen area
------------------------------------------------------------------------------
 Declaration
   screen.hdr

 Syntax
   proc savearea extern
   param value uint uTop, ;
         value uint uLeft, ;
         value uint uBottom, ;
         value uint uRight

 Arguments
   uTop is the top row of the screen area.

   uLeft is the leftmost column of the screen area.

   uBottom is the bottom row of the screen area.

   uRight is the rightmost column of the screen area.

 Return
   None.

 Description
   The savearea() procedure saves the current screen image from uTop,
   uLeft to uBottom, uRight. To restore the screen image, use the
   restorearea() procedure.

   An area of the screen can be saved many times without calling
   restorearea(), allowing stacked screens. savearea() and restorearea()
   are stack based procedures. That is, the first screen saved is the last
   screen restored.

 Example
   #define EXAMPLE_SCREEN
   #include example.hdr

   proc Test_savearea
   DrawScreen( 'A' )
   savearea( 10, 10, 20, 20 )
   wait
   DrawScreen( 'B' )
   wait
   restorearea()
   wait
   endproc

   proc main
   Test_savearea()
   endproc