IG_fltr_pageswap_file

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.