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 Professional.
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:
- 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().