ImageGear for C and C++ on Windows v19.4 - Updated
IG_IP_NR_ROI_control_get
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Image Processing Functions > IG_IP_NR_ROI_control_get

This function will return to you the current setting of any of the non-rectangular ROI control settings.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_IP_NR_ROI_control_get(
        HIGEAR hIGear, 
        AT_MODE  nAttributeID, 
        VOID FAR32* lpData
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle of image for which you would like to query ROI settings.
nAttributeID AT_MODE Set to an AT_MODE constant for the type of attribute you wish to query. See Remarks.
lpData VOID FAR32* This returns the current setting of nAttributeID.

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;
BOOL    bUseNonRect;
AT_POINT        ptReferencePoint;
/* Find out whether the image rectangle for hIGear is set to be overridden by a non-
rectangular ROI    */
nErrcount = IG_IP_NR_ROI_control_get (hIGear, IG_CONTROL_NR_ROI_STATE, &bUseNonRect);
/* Find out what the reference point for a mask HIGEAR is in the hIGear */
nErrcount = IG_IP_NR_ROI_control_get (hIGear, IG_CONTROL_NR_ROI_REFERENCE_POINT,
&ptReferencePoint);

Remarks:

Supply ImageGear with the HIGEAR handle of the image you are querying and the attribute (nAttributeID) whose setting you would like to query. The ROI settings currently available are:

To change these settings and for details on how these controls can be used, see the description for IG_IP_NR_ROI_control_set().