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.

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.