ImageGear for C and C++ on Windows v19.1 - Updated
IG_ascii_import
API Reference Guide > Core Component API Reference > Core Component Functions Reference > ASCII Functions > IG_ascii_import

This function loads an ASCII (.TXT) file into ImageGear.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_ascii_import (
        const LPSTR lpszFileName, 
        UINT nPageNumber, 
        LPHIGEAR lphIGear
);

Arguments:

Name Type Description
lpszFileName const LPSTR Set to the path/filename of the text file to load.
nPageNumber UINT Set to the number of the page to load; if not a multi-page file, set to 1.
lphIGear LPHIGEAR A far pointer that returns a HIGEAR handle for your newly loaded image.

Return Value:

Error count.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

None

Remarks:

Specify the path/filename of the file and which page of the file (if it is a multi-page file) you would like to load. ImageGear then returns a HIGEAR handle to the newly loaded image.

To set the control parameters of the loaded file, use IG_fltr_ctrl_set(). The TXT filter control parameters are listed in the section TXT (ASCII Text).

You may also use IG_load_file() to load an ASCII file.