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_NR_ROI_mask_unassociate
In This Topic
    IG_IP_NR_ROI_mask_unassociate
    In This Topic

    This function clears the non-rectangular ROI information from a HIGEAR image.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_IP_NR_ROI_mask_unassociate(HIGEAR hIGear);
    

    Arguments:

    Name Type Description
    hIGear HIGEAR HIGEAR handle to the image for which you would like to remove the association to the mask HIGEAR.

    Return Value:

    Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

    Supported Raster Image Formats:

    This function does not process image pixels.

    Sample:

    Image Processing, FlashPix

    Example:

     
    Copy Code
    AT_ERRCOUNT  nErrcount;
    HIGEAR hIGear;
    nErrcount = IG_IP_NR_ROI_mask_unassociate(hIGear);
    

    Remarks:

    This function does not delete the mask HIGEAR, it only removes the reference to it from this HIGEAR. To delete the mask HIGEAR, call IG_IP_NR_ROI_mask_delete().

    See the description for IG_IP_NR_ROI_mask_associate() function for more information.

    To delete the mask HIGEAR, use IG_image_delete() function.