IG_fltr_pageinfo_get_ex

This function obtains information about the page specified by the nPage parameter from a named multi-page file without actually loading it.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_fltr_pageinfo_get_ex_W( const LPAT_WCHAR lpwszFileName, UINT nPage, LPAT_MODE lpFileType, LPAT_MODE lpCompression, HIGDIBINFO* lphDIB );

Arguments:

Name	Type	Description
lpwszFileName	const LPAT_WCHAR	Path and name of the file about which to get the information, specified as a wide string (UTF-16). The path can be absolute or relative.
nPage	UINT	Number of the page in a multi-page file for which to get information.
lpFileType	LPAT_MODE	Pointer to an AT_MODE variable in which the file type will be returned. See enumIGFormats for possible values.
lpCompression	LPAT_MODE	Pointer to an AT_MODE variable in which compression type will be returned. See enumIGCompressions for possible values.
lphDIB	HIGDIBINFO*	Pointer to HIGDIBINFO object to which other file information, such as width, height, Bits Per Pixel, etc. will be returned.

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:

GUI Windows

Example:

	Copy Code
AT_ERRCOUNT nErrCount; AT_MODE fileType; AT_MODE compression; HIGDIBINFO hDIB; nErrCount = IG_fltr_pageinfo_get_ex_W(L"picture.tif", 1, &fileType, &compression, &hDIB); if(nErrCount == 0) { // ... // Delete DIB info IG_DIB_info_delete(hDIB); }

Copy Code

AT_ERRCOUNT nErrCount;
AT_MODE fileType;
AT_MODE compression;
HIGDIBINFO hDIB;

nErrCount = IG_fltr_pageinfo_get_ex_W(L"picture.tif", 1,
    &fileType, &compression, &hDIB);
if(nErrCount == 0)
{
    // ...
    // Delete DIB info
    IG_DIB_info_delete(hDIB);
}

Remarks:

Any of the output parameters such as lpFileType, lpCompression, or lphDIB can be NULL, if the corresponding info is not required.

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_pageinfo_get_ex.