ImageGear for C and C++ on Linux v19.10 - Updated
IG_IP_NR_ROI_mask_unassociate
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_NR_ROI_mask_unassociate

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.

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.