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

 repaintareax()      Restore a saved screen area
------------------------------------------------------------------------------
 Declaration
   screen.hdr

 Syntax
   proc repaintareax extern
   param value uint nScreenNumber

 Arguments
   nScreenNumber is an order number of a saved screen.

 Return
   None.

 Description
   This procedure works similar to repaintarea(), i. e. it repaints a
   previously saved screen area without removing it from the save stack.
   Other than repaintarea(), which repaints the last image saved
   (i. e. the image on top of the stack), this procedure expects a parameter
   which specifies the screen number to be repainted. Screen numbers count in
   reverse order, i. e. 1 specifies the most recently saved image, 2 the
   previously saved image, etc.

   If uScreenNumber exceeds the total number of saved images, a runtime
   error will be issued.

 Example
   #define EXAMPLE_SCREEN
   #include example.hdr

   proc Test_repaintareax
   @ 10, 10 ?? "1"
   savearea( 9, 9, 11, 11)
   
   @ 10, 10 ?? "2"
   savearea( 9, 9, 11, 11)
   
   @ 10, 10 ?? "3"
   savearea( 9, 9, 11, 11)
   
   clear
   repaintareax( 1 )       // displays "3"
   getkey()
   
   clear
   repaintareax( 2 )       // displays "2"
   getkey()
   
   clear
   repaintareax( 3 )       // displays "1"
   getkey()
   endproc

   proc main
   Test_repaintareax()
   endproc