This function creates a new file with an exact copy of the source file's pixel data and with new metadata.

Declaration:

AT_ERRCOUNT ACCUAPI IG_fltr_metad_update_file_W(
   const LPAT_WCHAR lpwszFileNameSrc,
   const LPAT_WCHAR lpwszFileNameDest,
   AT_LMODE lFormatType,
   UINT nPageNumber
);

Arguments:

Return Value:

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

The function supports the following image file formats:

• TIFF (except TIFF-JPEG)
• JPEG
• JPEG 2000
• JPX

Sample:

None

Example:

AT_ERRCOUNT     nErrcount;            // Count of returned errors on stack

nErrcount = IG_fltr_metad_update_file_W(L"picture.tif", L"picture_new.tif", IG_FORMAT_TIF, 1);

Remarks:

Pixel data is not decoded but copied directly from source to destination file.

The function creates a new file that contains a copy of the source file data with the new metadata for required page. lFormatType parameter value should be the same as the source file format type. In a multi-page file, the rest of the pages are copied verbatim from source to destination file. The function obtains new metadata from metadata callback functions LPAFT_IG_METAD_ITEM_SET_CB and LPAFT_IG_METAD_ITEM_ADD_CB.

IG_fltr_metad_update_file() function can be used as follows:

• Use IG_fltr_pageinfo_get to get metadata for the page into your application's storage.
• Change metadata (add / delete / change metadata tags or metadata values).
• Call IG_fltr_metad_update_file() function, supplying the metadata tags to LPAFT_IG_METAD_ITEM_SET_CB and LPAFT_IG_METAD_ITEM_ADD_CB callbacks. nPageNumber and lFormatType parameter values should correspond to the loaded page and source file format.

Destination file will receive the copy of the source file, with new metadata for the specified page.

See also Updating Non-Image Data without Loading and Saving the Image.