Digital

NAME

XieCreateRoi − This routine creates an IDC type ROI. 

C Format

roi = XieCreateRoi(dpy, x, y, width, height)

C Argument Information

XieRoi      roi;
Display     ∗dpy;
long       x;
long       y;
unsigned long  width;
unsigned long  height;

RETURN VALUES

The routine returns the identifier of the newly created ROI in the roi argument. You can free the ROI using the XieFreeResource routine. 

PARAMETERS

dpyThe dpy argument specifies the X11 display identifier returned by the XOpenDisplay routine. 

xThe x argument specifies the x-coordinate of the upper left hand corner of the ROI. 

yThe y argument specifies the y-coordinate of the upper left hand corner of the ROI. 

widthThe width argument specifies the width of the ROI in pixels. 

heightThe height argument specifies the height of the ROI in scanlines. 

DESCRIPTION

This routine creates an IDC of type ROI. 

XIE Events and Error Messages

Protocol Messages: X_ieCreateByValue

XIE event returned: None

XieLib errors: None

XieServer errors: BadAlloc -- Insufficient server resources

BadIDChoice -- Invalid identifier

BadValue -- Height or width is 0