ImageGear for C and C++ on Windows v19.4 - Updated
IG_fltr_pageswap_file_W
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Filter Functions > IG_fltr_pageswap_file_W

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

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 "Getting Information about a Format Filter" in Loading and Saving.

This function may work slower on PDF and PostScript images, compared to its ANSI analog IG_fltr_pageswap_file.