
B–61863E–1/06
8. CRT CHARACTER DISPLAYPMC LIBRARY
229
SC/SC3/SC4 NB/NB2 16i/18i/21i 15i–A
f f
[Name]
pl_dspsave
[Description]
Saves the specified part of the screen being displayed, the entire
character display data, and attributes.
However, the cursor cannot be saved.
[Format]
ret = pl_dspsave(P1,P2,P3);
short ret ;
short P1 ;
short *P2 ;
unsigned char *P3 ;
[Input]
P1 Specifies screen saving.
By specifying numbers 1 to 5, a part of the character data and
attributes being displayed on the CRT screen can be saved.
Five screen parts can be saved and up to 80 characters can be
saved for each part.
P1 Specifies screen saving.
0 Specifies that the display characters for one screen are to be saved.
1 to 5 Specifies that part of the screen (up to 80 characters) is to be saved.
(Five screen parts)
*P2 The start and end points for saving part of the screen, and the
number of columns to be saved (up to 80 characters) (NOTE1)
Start column
Start row
Number of columns to be saved (C)
*P3 Screen saving work area pointer (NOTE2)
[Output]
______
[Returns]
ret Completion code: –1, 0, 3, or 5
[Remarks]
NOTE
1 Up to 80 characters appears between the start and end
locations. P2 need not be set when one screen is saved.
2 The saving work buffer requires 11290 bytes. It is used for
screen restoration (pl_dspresave). However, 1690 bytes
are required only when part of the screen is saved.
8.15
SAVING THE CRT
CHARACTER
DISPLAY
0
2
4
6
P2
X coordinate
Y coordinate
C=1 to 80