ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / Filter Functions / IG_fltr_detect_set
In This Topic
    IG_fltr_detect_set
    In This Topic

    This function turns on or off the format detection procedure for the specified file format. It also sets the format detection priority.

    Declaration:

     
    Copy Code
    AT_ERRCODE ACCUAPI IG_fltr_detect_set(
       DWORD dwFormatID,
       AT_BOOL bDetectEnable,
       LONG nDetectPriority
    );
    

    Arguments:

    Name Type Description
    dwFormatID DWORD Specifies the format filter ID for which the detection flag and detection priority is set. See enumIGFormats for possible values.
    bDetectEnable AT_BOOL TRUE turns the detection on, FALSE turns it off.
    nDetectPriority LONG Detection priority to be used during the format detection procedure. Greater values correspond to higher priority.

    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:

    None

    Example:

     
    Copy Code
    AT_ERRCOUNT     nErrcount;            // Count of returned errors on stack
    nErrcount = IG_fltr_detect_set(IG_FORMAT_TIF, TRUE, 100);