IG_REC_zone_node_array

Retrieves the polygon made up of the vertices of the user zone.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_REC_zone_node_array_get( HIG_REC_IMAGE hImage, AT_INT nZoneIndex, LPAT_POINT* lplpNodes, LPAT_INT lpNodeCount );

Arguments:

Name	Type	Description
hImage	HIG_REC_IMAGE	Image handle.
nZoneIndex	AT_INT	Index of the zone in the zone list, from which the information is requested.
lplpNodes	LPAT_POINT*	Pointer to an array of AT_POINT structures for storing the requested node information. Can't be NULL. After evaluating the result, the application should call IG_REC_free to free this array.
lpNodeCount	LPAT_INT	Pointer to a number variable for storing the number of nodes in the lplpNodes array. Can't be NULL.

Return Value:

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

Supported Raster Image Formats:

See IG_REC_image_import.

Example:

	Copy Code
AT_ERRCOUNT ErrCount = 0; HIG_REC_IMAGE higRecImage = 0; HIGEAR higImage = 0; AT_INT iZoneCount = 0; LPAT_POINT lpPts = 0; AT_INT iPtsNum = 0; ErrCount = IG_load_file("Multipage.tif", &higImage); ErrCount = IG_REC_image_import(higImage, &higRecImage); ErrCount = IG_REC_zones_locate(higRecImage, NULL); ErrCount = IG_REC_zones_count_get(higRecImage, &iZoneCount); if(iZoneCount) ErrCount = IG_REC_zone_node_array_get(higRecImage, 0, &lpPts, &iPtsNum); ErrCount = IG_REC_image_delete(higRecImage); ErrCount = IG_image_delete(higImage); ErrCount = IG_REC_free(lpPts);

Copy Code

AT_ERRCOUNT ErrCount = 0;
HIG_REC_IMAGE higRecImage = 0;
HIGEAR higImage = 0;
AT_INT iZoneCount = 0;
LPAT_POINT lpPts = 0;
AT_INT iPtsNum = 0;

ErrCount = IG_load_file("Multipage.tif", &higImage); 
ErrCount = IG_REC_image_import(higImage, &higRecImage);
ErrCount = IG_REC_zones_locate(higRecImage, NULL);

ErrCount = IG_REC_zones_count_get(higRecImage, &iZoneCount);
if(iZoneCount)
        ErrCount = IG_REC_zone_node_array_get(higRecImage, 0, &lpPts, &iPtsNum);

ErrCount = IG_REC_image_delete(higRecImage);
ErrCount = IG_image_delete(higImage);
ErrCount = IG_REC_free(lpPts);

Remarks:

This can be useful for an application with a GUI when drawing irregular zones.