TEXWRIT

Description

Transfers a text segment from a PCIDSK file to a text file.

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	Input file name	1 - 192
TEXSEG *	Integer	Input text segment	1 - 1
TFILE *	String	Output text file name	1 - 192

* Required parameter

Parameter descriptions

FILE

Specifies the name of the PCIDSK image file that contains the text segment.

TEXSEG

Specifies the number of the text segment (type 140) to transfer to a text file.

TFILE

Specifies the name of the text file to receive the text segment data.

The specified output file must not already exist before running TEXWRIT.

Details

TEXWRIT transfers text information from an existing text segment (TEXSEG) in an image file (FILE) to a new text file (TFILE).

TEXWRIT allows you to edit information (for example, attribute data) contained in the text segment by transferring the data to a text file. You can then use TEXREAD to replace the edited text data in the original text segment.

Examples

Edit attribute data contained in text segment 19 of the demo file, irvine.pix. To do this, create a text file from the text segment.

EASI>file	=	"irvine.pix"
EASI>texseg	=	19
EASI>tfile	=	"attrib.txt"

EASI>RUN TEXWRIT

After editing the text file attrib.txt, use TEXREAD to create a new text segment in the image file. The text file is checked for the attribute format.

EASI>file	=	"irvine.pix"
EASI>texseg	=	""
EASI>texform	=	"att"
EASI>dbsn	=	"edited"
EASI>dbsd	=	"edited attribute data from segment 19"
EASI>tfile	=	"attrib.txt"

EASI>RUN TEXREAD