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

                                 L_RESTSCR()


Syntax:        L_RESTSCR(<expN1>,<expN2>,<expN3>,<expN4>,
               <expC1>[,<expC2>][,<expN5>])


Purpose:       Allows screens that were saved using L_SAVESCR() to be
               restored from a disc file.


Arguments:     <expN1>, <expN2> are the row and column co-ordinates of
               the top left hand corner of the area to be restored;
               (0,0 to 22,77 valid).

               <expN3>, <expN4> are the row and column co-ordinates of
               the bottom right hand corner of the area to be
               restored; (2,2 to 24,79 valid).

               <expC1> is the name and path of the file from which the
               screen is to be restored.

               <expC2> is the optional name that can be used to search
               for the screen; max 10 characters. The default name is
               "default".

               <expN5> is the optional location within the file from
               which to restore the screen.


Returns:       A Library error message if the find was not successful
               (Appendix D) or else a logical (.T.).


Usage:         Up to 99 screens can be saved in a single file. This
               function can be used to reduce the memory overheads of
               having many screens held in RAM.


Examples:      L_RESTSCR(0,0,10,10,"svscr.scr")               && Result: .T.

               L_RESTSCR(0,0,10,10,"svscr.scr","Data_in 1")    && Result: .T.

               L_RESTSCR(0,0,10,10,"svscr.scr","",3)           && Result: .T.

               L_RESTSCR(0,0,10,10,"svscr.scr","Data_in 2",2)  && Result: .T.


Notes:         If the file given does not exist, then an error message
               will be returned.  When a screen is being restored from
               file, if the  name and position are not specified, then
               the first screen in the file will be restored.

               If just a name is specified, then the first screen to
               match that name will be restored. If no screen matches
               the name then an error message will be returned.

               If just a position is specified, then the screen from
               that position within the file will be restored. In this
               case, a null string must be passed to the function in

               the place of the screen name.  If the position
               specified is beyond the end of the file then an error
               message will be returned.

               If both name and position are specified, then the
               screen restored will be the first to match either name
               or position.


Language:      Clipper