This function has been deprecated and will be removed from the API in version 18 of ImageGear. Please use IG_fltr_metad_callback_set instead.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI IG_save_tag_CB_register( LPFNIG_TAG_GET lpfnTagGet, LPFNIG_TAG_USER_GET lpfnTagUserGet, LPVOID lpPrivate ); |
|
Arguments:
| lpfnTagGet | Pointer to callback function to be called during save operationS, prior to saving each Tag. |
| lpfnTagUserGet | Pointer to callback function to be called to obtain additional user Tags. |
| lpPrivate | Pointer to private data (passed to callback function). |
Return Value:
Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.Supported Raster Image Formats:
This function does not process image pixels.
Sample:
JPEG, Filters
Example:
| Copy Code |
|
|---|---|
LPFNIG_TAG_GET MyTagChanger = NULL; // To change existing tags LPFNIG_TAG_USER_GET MyTiffTagger = NULL; // Can add new tags char* lpPrivate = NULL; // Pointer to private area IG_save_tag_CB_register ( MyTagChanger, MyTiffTagger, (LPVOID) lpPrivate ); |
|
Remarks:
This function registers a callback function to be called for each Tag while saving a file.
A default value of the Tag is supplied, and can be changed in the callback function. See the description for callback function type LPFNIG_TAG_GET.
The second callback function you supply is of type LPFNIG_TAG_USER_GET, and permits you to provide additional tags. This can be used to add additional TIFF Tags when saving in TIFF format.