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

 SAVE SCREEN*
 Save current screen to a buffer or variable
------------------------------------------------------------------------------
 Syntax

     SAVE SCREEN [TO <idVar>]

 Arguments

     TO <idVar> specifies a variable to contain the current screen
     contents as a character value.  If <idVar> is not visible or does not
     exist, a private memory variable is created and assigned to the screen.

 Description

     SAVE SCREEN is a command synonym for the SAVESCREEN() function that
     saves the screen from 0, 0 to MAXROW(), MAXCOL() in a the default screen
     buffer, or an optional variable.  If the screen is saved to a variable,
     the variable can be any storage class including field, local, static, or
     an array element.  Note, however, you cannot SAVE an array or local or
     static variable to (.mem) files to save multiple screens to disk.

     SAVE SCREEN is used with RESTORE SCREEN to eliminate repainting an
     original screen that has been temporarily replaced.  You may save
     multiple screens by assigning each screen to a separate variable.

     SAVE SCREEN is a compatibility command and not recommended.  It is
     superseded by the SAVESCREEN() function which can save partial or full
     screens.

     Warning!  SAVE SCREEN, RESTORE SCREEN, SAVESCREEN(), and
     RESTSCREEN() are supported when using the default (IBM PC memory mapped)
     screen driver.  Other screen drivers may not support saving and
     restoring screens.

 Examples

     .  This code skeleton uses a static array to store saved screens:

        STATIC aScreens[10]
        SAVE SCREEN TO aScreens[1]
        //
        <statements>...
        //
        RESTORE SCREEN FROM aScreens[1]

     .  This example saves and restores screens using a database file:

        USE Screens INDEX Name NEW
        APPEND BLANK

        Screens->Name := "Screen001"          // Save the screen name
        SAVE SCREEN TO Screens->Image         // Save a new screen image
        //
        <statements>...
        //
        SEEK "Screen001"                      // Find the screen
        RESTORE SCREEN FROM Screens->Image    // Restore it

 Files:  Library is CLIPPER.LIB.