ImageGear for C and C++ on Windows v19.6 - Updated
ART_file_export
API Reference Guide > ART Component API Reference > ART Component Functions Reference > File Functions > ART_file_export

This function saves the marks associated with the HIGEAR image to a separate .ART file.

Declaration:

 
Copy Code
AT_ERRCOUNT ART_file_export(
        HIGEAR hIGear, 
        const LPSTR lpszFileName, 
        DWORD dwPageNumber, 
        BOOL fReplace
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle to the image.
lpszFileName const LPSTR A far pointer to a NULL-terminated string containing the name of the .ART file to export.
dwPageNumber DWORD Use this parameter to save one page of an existing file to a new file. Set this parameter to the page number of the .ART file that you want to save to the new file.
fReplace BOOL This parameter is relevant if the target .ART file already exists and has multiple pages. Set to TRUE to replace the page; set to FALSE to insert the page.

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++.

Sample:

Annotation

Example:

 
Copy Code
HIGEAR hIGear; /* HIGEAR handle of image */
char FAR *szARTFile; /* Name of the ART file  */
/* to export  */
AT_ERRCOUNT nErrcount; /* Tally of IG errors on stack */
szARTFile = "ARTsnack.ART";
nErrcount = IG_save_file(hIGear, "Snack.png", 
IG_SAVE_PNG);
nErrcount = ART_file_export(hIGear, szARTFile, 2, 
FALSE);

Remarks:

Other ways to save marks: