ImageGear for C and C++ on Linux v19.10 - Updated
ART_file_import
API Reference Guide > ART Component API Reference > ART Component Functions Reference > File Functions > ART_file_import

This function loads the marks from a separate .ART file into the HIGEAR image.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_file_import(
        HIGEAR hIGear, 
        HWND hWnd, 
        DWORD dwGrpID, 
        const LPSTR lpszFileName, 
        DWORD dwPageNumber
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
hWnd HWND HWND handle to the window.
dwGrpID DWORD Identifier of group.
lpszFileName const LPSTR A far pointer to the name of the .ART file to import.
dwPageNumber DWORD Set this parameter to the page number to load if the .ART file has multiple pages. If the .ART file has one page, set this to 1.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Example:

 
Copy Code
HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szARTFile; /* Name of the ART file  */
/* to import  */
AT_ERRCOUNT nErrcount; /* Tally of IG errors on stack */
HWND hWnd;
DWORD dwGrpID;
nErrcount = IG_load_file("JoeFax.BMP", &hIGear);
dwGrpID = IG_GRP_DEFAULT;
nErrcount = ART_file_import(hIGear, hWnd, dwGrpID, 
szARTFile, 1);

Remarks:

This function is typically used for combining a newly loaded image with marks that were previously made and saved separately to an .ART file.

See also ART_file_import_ex() function.