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

SAVE SCREEN

Save whole screen image and coordinate to an internal buffer
---------------------------------------------------------------------------------

 Syntax

        SAVE SCREEN  

 Arguments

        none.    

 Returns

       SAVE  SCREEN always return NIL.    

 Description

      SAVE SCREEN save the image of the whole screen into an internal
      buffer, it also save current cursor position. The information could
      later be restored by REST SCREEN. Each call to SAVE SCREEN
      overwrite the internal buffer.

      SAVE SCREEN command is preprocessed into __XSaveScreen() function
      during compile time. Note that SAVE SCREEN TO is preprocessed into
      SAVESCREEN() function.

 Examples

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

Status

      Ready

 Compliance

      __XSaveScreen() works exactly like CA-Clipper's __XSaveScreen()

 Platforms

      __XSaveScreen() is part of the GT API, and supported only by some
       platforms.