curs_scr_dump(S)
curs_scr_dump: scr_dump, scr_restore, scr_init, scr_set --
read (write) a curses screen from (to) a file
Syntax
cc ... -lcurses
#include <curses.h>
int scr_dump(char *filename);
int scr_restore(char *filename);
int scr_init(char *filename);
int scr_set(char *filename);
Description
scr_dump
With the
scr_dump(S)
routine,
the current contents of the virtual screen are written to the file
filename.
scr_restore
With the
scr_restore(S)
routine,
the virtual screen is set to the contents of
filename,
which must have been written using
scr_dump( ).
The next call to
doupdate(S)
restores the screen to the way it looked in the dump file.
scr_init
With the
scr_init(S)
routine,
the contents of filename
are read in and used to initialize the
curses(S)
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(S)
or a
system(S)
call to share the screen with another process which has done a
scr_dump( )
after its
endwin(S)
call.
The data is declared invalid if the time-stamp of the
tty is old or the
terminfo capabilities
rmcup
and
nrrmc
exist.
scr_init
The
scr_set(S)
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 routines
getwin(S)
and
putwin(S).
Return values
All routines return the integer
ERR on failure and
OK on success.
Warning
The header file curses.h automatically includes the header files
stdio.h and unctrl.h.
The following can be macros:
scr_init( ),
scr_set( ),
and
scr_restore( ).
Files
/usr/lib/libcurses.a-
the library
See also
curses(S),
curs_initscr(S),
curs_refresh(S),
curs_util(S),
system(S)
Standards conformance
scr_dump(S),
scr_restore(S),
scr_set(S),
and
scr_init(S)
are not part of any
currently supported standard;
they were developed by UNIX System Laboratories, Inc. and
are maintained by The SCO Group.
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003