This function swaps two pages in a multi-page file.
Declaration:
Copy Code | |
---|---|
AT_ERRCOUNT ACCUAPI IG_fltr_pageswap_file_W(
const LPAT_WCHAR lpwszFileName,
AT_MODE nFormatType,
UINT nPage1,
UINT nPage2
);
|
Arguments:
Name | Type | Description |
lpwszFileName | const LPAT_WCHAR | Path and name of the file in which to swap the pages, specified as a wide string (UTF-16). The path can be absolute or relative. |
nFormatType | AT_MODE | A constant indicating the file format of the input file. See enumIGFormats for possible values. Set to IG_FORMAT_UNKNOWN to let ImageGear detect the file format. |
nPage1 | UINT | Number of page 1 to swap with page 2. |
nPage2 | UINT | Number of page 2 to swap with page 1. |
Return Value:
Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.Supported Raster Image Formats:
All pixel formats supported by ImageGear Professional.
Sample:
None
Example:
Copy Code | |
---|---|
AT_ERRCOUNT nErrcount; // Count of returned errors on stack nErrcount = IG_fltr_pageswap_file_W(L"picture_multipage.tif", IG_FORMAT_TIF, 1, 2); |
Remarks:
Use IG_fltr_info_get function to determine whether the format filter supports page swapping. If the flags returned by this function contain IG_FLTR_PAGESWAPSUPPORT, then the format filter supports the swapping procedure.
See also the section Getting Information and Sorting Images.
This function may work slower on PDF and PostScript images, compared to its ANSI analog IG_fltr_pageswap_file. |