ImageGear Professional DLL v17.1 for Windows Accusoft
IG_fltr_info_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Functions Reference > Filter Functions > IG_fltr_info_get

Glossary Item Box

This function returns information about the format filter and its supported features.

Declaration:

  Copy Code 
AT_ERRCOUNT ACCUAPI IG_fltr_info_get(
   AT_MODE nFormatID,
   LPDWORD lpdwInfoFlags,
   LPCHAR lpShortName,
   DWORD dwSNameSize,
   LPCHAR lpFullName,
   DWORD dwFNameSize,
   LPCHAR lpDefExt,
   DWORD dwDefExtSize
);

Arguments:

nFormatID File format identifier. See enumIGFormats for possible values.
lpdwInfoFlags Pointer to a variable which will receive the format flags. Any combination of enumIGFltrFormatFlags values can be returned.
lpShortName Pointer to a byte array which will receive the zero-terminated string with the short file format name. Set to NULL if you do not need to obtain this information.
dwSNameSize Size of the lpShortName array in bytes.
lpFullName Pointer to a byte array which will receive the zero-terminated string with the full file format name. Set to NULL if you do not need to obtain this information.
dwFNameSize Size of the lpFullName array in bytes.
lpDefExt Pointer to a byte array which will receive the zero-terminated string with file masks such as *.tif separated by a semicolon (;). Set to NULL if you do not need to obtain this information.
dwDefExtSize Size of lpDefExt array in bytes.

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

MemIO

Example:

  Copy Code 
AT_CHAR shortName[_MAX_PATH];
AT_CHAR fullName[_MAX_PATH];
AT_CHAR defExt[_MAX_PATH];
DWORD dwFlags;

AT_ERRCOUNT nErrCount;
nErrCount = IG_fltr_info_get(IG_FORMAT_TIF, &dwFlags, shortName, sizeof(shortName),
    fullName, sizeof(fullName), defExt, sizeof(defExt));

// Output the filter info
if(dwFlags & IG_FLTR_DETECTSUPPORT)
    printf("IG_FLTR_DETECTSUPPORT\n");
if(dwFlags & IG_FLTR_PAGEREADSUPPORT)
    printf("IG_FLTR_PAGEREADSUPPORT\n");
if(dwFlags & IG_FLTR_MPAGEREADPSUPPORT)
    printf("IG_FLTR_MPAGEREADPSUPPORT\n");
if(dwFlags & IG_FLTR_MPAGEWRITEPSUPPORT)
    printf("IG_FLTR_MPAGEWRITEPSUPPORT\n");
if(dwFlags & IG_FLTR_PAGEINSERTSUPPORT)
    printf("IG_FLTR_PAGEINSERTSUPPORT\n");
if(dwFlags & IG_FLTR_PAGEDELETESUPPORT)
    printf("IG_FLTR_PAGEDELETESUPPORT\n");
if(dwFlags & IG_FLTR_PAGESWAPSUPPORT)
    printf("IG_FLTR_PAGESWAPSUPPORT\n");
if(dwFlags & IG_FLTR_MPDATASUPPORT)
    printf("IG_FLTR_MPDATASUPPORT\n");

printf("Short name: %s\nFullName: %s\nDefault Extension: %s\n", shortName, fullName, defExt);

Remarks:

This function returns a short format name - usually 3-4 chars (e.g., "TIFF"), full format name (e.g., "Tagged Image File Format"), and default file extensions separated by ";" (e.g., "*.tif;*.tiff").

See also the section Getting Information and Sorting Images.

©2012. Accusoft Corporation. All Rights Reserved.