xil_roi_get_as_region(3)
NAME
xil_roi_get_as_region − get an X region version of an ROI
SYNOPSIS
#include <xil/xil.h>
Region xil_roi_get_as_region ( XilRoi roi);
DESCRIPTION
This function returns a handle to an X region that corresponds to the supplied ROI.
ERRORS
For a complete list of XIL error messages by number, consult Appendix B of the XIL Programmer’s Guide.
EXAMPLES
Get the ROI associated with an image. Then create an X region that corresponds to the ROI returned:
XilSystemState State;
XilImage image;
XilRoi roi;
Region region;
roi = xil_get_roi (image);
if (roi == NULL) {
/∗ The image had no ROI associated with it,
create one that encompasses the whole image ∗/
roi = xil_roi_create (State);
xil_roi_add_rect (roi, 0, 0, xil_get_width(image), xil_get_height(image));
}
region = xil_roi_get_as_region (roi);
SEE ALSO
xil_get_roi(3), xil_set_roi(3), xil_roi_add_image(3), xil_roi_add_rect(3), xil_roi_add_region(3), xil_roi_create(3), xil_roi_create_copy(3), xil_roi_destroy(3), xil_roi_get_as_image(3), xil_roi_intersect(3), xil_roi_subtract_rect(3), xil_roi_translate(3), xil_roi_unite(3), XCreateRegion (3), XPolygonRegion (3).
SunOS 5.6 — Last change: 16 June 1993