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

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

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.