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

RESTORE SCREEN

Restore screen image and coordinate from an internal buffer
---------------------------------------------------------------------------------

 Syntax

        RESTORE SCREEN  

 Arguments

        none.    

 Returns

       REST  SCREEN always return NIL.    

 Description

      Rest Screen restore saved image of the whole screen from an  internal
      buffer that was saved by Save Screen, it also restore  cursor
      position. After a call to Rest Screen the internal buffer  is
      cleared.

      RESTORE SCREEN command is preprocessed into __XRestScreen() function
      during compile time. Note that RESTORE SCREEN FROM is preprocessed
      into RESTSCREEN() function.

 Examples

      // save the screen, display list of files than restore the screen
      SAVE SCREEN
      DIR *.*
      WAIT
      RESTORE SCREEN

Status

      Ready

 Compliance

      Rest Screen() works exactly like CA-Clipper's Rest Screen

 Platforms

      Rest Screen is part of the GT API, and supported only by some
       platforms.