tvsave(srow.i2.r, nrows.i2.r, scol.i2.r, ncols.i2.r, vun.i2.r,
recno.i2.r, recsiz.i2.r, status.i2.r)
tvsave_c(srow.i4.v, nrows.i4.v, scol.i4.v, ncols.i4.v, vun.i1.v,
recno.i4.v, recsiz.i4.v, status.i1.r)
This routine will read a rectangular area from the color TV display,
compress it, and store it into a filesharing record The compression
method usually gives savings of more than 50% compared with TVMX format.
Even reasonably dense 48 by 120 images will fit into a 3930 byte
record. Only changes of color code are stored. Blink codes are not
stored. Repeated characters are stored as a repeat count and the
character code. In order to limit the number of color codes stored,
the foreground color of blank characters may be changed to be the same
as that of the previous character. A compressed image can be displayed
using the TVDISP routine.
srow starting TV row of the area to save.
nrows number of rows in the area to save.
scol starting TV column of the area to save.
ncols number of columns in the area to save.
vun virtual unit number of the filesharing file into
which the compressed image will be written. The calling
program must have previously opened this file for write access.
recno record number of the record into which the
compressed image will be written.
recsiz record size in bytes. An error will be indicated if
image will not fit into a record of this size.
status error status as follows:
-8 parameter error (arguments out of range)
-11 invalid image size (number of rows or cols)
-13 image will not fit into record
Filesharing ACNET error codes
This function requires the following include files:
tvdisp(_c), window_tvsave_c, window_tvdisp(_c)