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

    Detects an area of pixels using a user-defined pixel checker and returns the area being detected as a ROI structure.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_IP_detect_area(
            HIGEAR hIGear, 
            AT_INT xPos, 
            AT_INT yPos, 
            LPAT_VOID detectStruct, 
            LPFNIG_CHECK_PIXEL detectFunc,
            LPAT_RECT lpRect,  
            AT_NR_ROI_MASK* lpMask
    ); 
    

    Arguments:

    Name Type Description
    hIGear HIGEAR Image to analyze.
    xPos AT_INT X coordinate of a point inside the area to be detected.
    yPos AT_INT Y coordinate of a point inside the area to be detected.
    detectStruct LPAT_VOID A pointer to a user-defined structure that will be passed to the callback function. See LPFNIG_CHECK_PIXEL.
    detectFunc LPFNIG_CHECK_PIXEL Callback function that checks whether specified pixel belongs to the area or not.
    lpRect LPAT_RECT Rectangular area to apply the effect to, or NULL for whole image.
    lpMask AT_NR_ROI_MASK* Returns the ROI mask.

    Return Value:

    Returns the number of ImageGear errors that occurred during this function call.

    Supported Raster Image Formats:

    All pixel formats supported by ImageGear for C and C++.

    Actual set of pixel formats supported by this function can be narrower, depending on the implementation of the user-defined callback function.