This function loads the marks from a separate .ART file into the HIGEAR image.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ART_file_import_ex(
HIGEAR hIGear,
HWND hWnd,
DWORD dwGrpID,
const LPSTR lpszFileName,
DWORD dwPageNumber,
BOOL bAppend
);
|
|
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. |
| bAppend | BOOL | If this parameter is TRUE, then current ART annotation will be simply added to the specified .ART file. Otherwise previous annotation in the file will be replaced by the current one. |
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:
None
Remarks:
This is typically used for combining a newly loaded image with marks that were previously made and saved separately to an .ART file.
This function is the same as ART_file_import(), but has supplementary parameter bAppend that allows you to determine if current ART annotation should be simply added to the specified .ART file (TRUE), or replace the existing one (FALSE).