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

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);

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:

Marks may be saved as an embedded file, but only if the format of the image file is TIFF - see ART_control_option_set()
Marks may also be "burned in" permanently to an image using ART_image_burn_in().