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

Glossary Item Box

This function detects the format of the image file specified by a filename.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_fltr_detect_file(
   const LPSTR lpszFileName,
   LPAT_MODE lpFileType
);

Arguments:

lpszFileName File name of the image which format you wish to detect.
lpFileType Pointer to an AT_MODE variable in which the file type will be returned. See enumIGFormats for possible values. If the file format can not be detected, this parameter will return IG_FORMAT_UNKNOWN.

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:

Filter, Recognition

Example:

  Copy Code
AT_ERRCOUNT nErrCount; // will hold returned error count
AT_MODE nFormatID;

nErrCount = IG_fltr_detect_file("picture.tif", &nFormatID);
if(nFormatID == IG_FORMAT_TIF)
{
    // ...
}

Remarks:

See also the section Detecting Image File Format.

©2012. Accusoft Corporation. All Rights Reserved.