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

 saveareatofile()    Save screen area to disk file
------------------------------------------------------------------------------
 Declaration
   screen.hdr

 Syntax
   func logical saveareatofile extern
   param value uint uTop, ;
         value uint uLeft, ;
         value uint uBottom, ;
         value uint uRight, ;
         const char cFile

 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.

   cFile is the file name for the saved screen.

 Return
   A logical indicating the success of operation.

 Description
   This function saves a screen area to the specified file for later use by
   restoreareafromfile(). It returns .t. if the area could be saved
   successfully.

 Example
   #define EXAMPLE_SCREEN
   #include example.hdr

   proc Test_saveareatofile
   DrawScreen( 'A' )                        // draw a screen
   saveareatofile( 0, 0, __max_row, __max_col, "screen.sav" ) // save screen
   wait
   DrawScreen( 'B' )                        // darw another screen
   wait
   restoreareafromfile( "screen.sav" )      // restore screen
   wait
   erase "screen.sav"                       // clean up
   endproc

   proc main
   Test_saveareatofile()
   endproc