Next: , Previous: Refresh windows and lines, Up: The basic curses library   [Contents][Index]


5.2.34 Reading and writing a curses screen to a file

Procedure: scr-dump filename

The scr-dump routine dumps the current contents of the virtual screen to the file filename.

Procedure: scr-restore filename

The scr-restore routine sets the virtual screen to the contents of filename, which must have been written using scr-dump. The next call to doupdate restores the screen to the way it looked in the dump file.

Procedure: scr-init filename

The scr-init routine reads in the contents of filename and uses them to initialize the curses data structures about what the terminal currently has on its screen. If the data is determined to be valid, curses bases its next update of the screen on this information rather than clearing the screen and starting from scratch. scr-init is used after initscr or a system call to share the screen with another process which has done a scr-dump after its endwin call. The data is declared invalid if the terminfo capabilities rmcup and nrrmc exist; also if the terminal has been written to since the preceding scr-dump call.

Procedure: scr-set filename

The scr-set routine is a combination of scr-restore and scr-init. It tells the program that the information in filename is what is currently on the screen, and also what the program wants on the screen. This can be thought of as a screen inheritance function.

To read (write) a window from (to) a file, use the getwin and putwin routines.

All routines return the integer #f upon failure and #t upon success.


Next: , Previous: Refresh windows and lines, Up: The basic curses library   [Contents][Index]