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); } |
|
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. |