IN_ExtractText

All Editions image\bltlrgsq_shg.gif  Related Functions  image\bltlrgsq_shg.gif  Example

The IN_ExtractText function locates the text from all text objects on the specified edit layer, creates a file, and saves the text strings to it, separated by null bytes.

Syntax

int IN_ExtractText( layerID, pFileName, options, pCount )

Input Parameters

Values

Meaning

IN_LAYER layerID

identifier of layer to search

CHARPTR pFileName

pointer to the name of the file to create or open in which to save the extracted text

ULONG options

1 extract all text objects. See Remarks.

Output Parameters

Meaning

ULONGPTR pCount

pointer to the number of entries that were extracted

Remarks

The extracted text strings are separated by null bytes instead of CRLF (hard carriage return) characters because multilined text objects already contain CRLF characters.

Reserved for future use.

Release information

Added to Imagenation for Windows in Release 4.00.

As of Release 5.1, also available in Imagenation for UNIX.

Also supported in Imagenation 3.3 for UNIX.

See also

Searching for text