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

##############################################################################
###+--------------+###########################################################
#+-| RESTORE_AREA |---------------------------------+#########################
#| +--------------+ Restores the last screen saved  |#########################
#|                  by save_screen or save_area     |#########################
#+--------------------------------------------------+#########################
##############################################################################
##############################################################################
#+--| Summary |------------+##################################################
#|     #INCLUDE io.hdr     |##################################################
#+-------------------------+##################################################
##############################################################################
##############################################################################
#+--| Syntax |------------------------------+#################################
#|     PROCEDURE restore_area PROTOTYPE     |#################################
#+------------------------------------------+#################################
##############################################################################
##############################################################################
########+---| Description |-----------------------------------------+#########
########| The restore_area procedure restores the last screen saved |#########
########| by either the save_screen or save_area procedure.         |#########
########+-----------------------------------------------------------+#########
##############################################################################
##############################################################################
##########+---| Design |-------------------------------------------+##########
##########| The save_area and restore_area procedures behave as a  |##########
##########| stack.  That is, the first item saved is the last item |##########
##########| restored.  Use savescrn() and restorescrn functions if |##########
##########| you require random saving/restoring of screens.        |##########
##########+--------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Save portion of the screen for a memo field.        |#########
#########|                                                          |#########
#########| save_area ( 50,0,20,79 )                                 |#########
#########| DO edit_the_memo                                         |#########
#########| DO restore_area                                          |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    As long as screens can be restored in the order     |#########
#########| *    they are saved, the restore_area eliminates the     |#########
#########| *    need to manage screen variables.                    |#########
#########|                                                          |#########
#########| save_screen()               && #1 entire screen saved    |#########
#########| save_area(0,0,4,70)         && #2                        |#########
#########| save_area(10,20,24,40)      && #3                        |#########
#########| restore_area()              && restores screen 3         |#########
#########| restore_area()              && restores screen 2         |#########
#########| restore_area()              && restores entire screen    |#########
#########+----------------------------------------------------------+#########
##############################################################################