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 for C and C++.
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).