Digital

NAME

XieCrop − This routine creates a cropped version of a source image. 

C Format

dst_photo_id = XieCrop(src_id, idc_id)

C Argument Information

XiePhoto     dst_photo_id;
XiePhoto     src_id;
XieIdc      idc_id;

RETURN VALUES

The routine returns the identifier of the newly created image in the dst_photo_id argument if the source image is an unbound photomap. Otherwise, the routine returns the identifier of the photoflo to which the processing element is appended. You can free the photomap using the XieFreeResource routine. 

PARAMETERS

src_idThe src_id argument specifies the identifier of the source image. If the source image is an unbound photomap, the operation is performed immediately. Otherwise, a processing element is appended to the specified photoflo with execution pending a call to the XieExecuteFlo routine. The photoflo is specified explicitly if the source image is a photoflo, or implicitly if the source image is a photomap or phototap bound to the photoflo. 

idc_idThe idc_id argument specifies the identifier of the IDC of type ROI that defines the crop boundaries.  If you specify a value of 0, the entire source image is copied to the destination image. 

DESCRIPTION

This routine creates a cropped version of a source image. 

If the operation is performed immediately and you selected computation events using the XieSelectEvents routine, an XieK_ComputationEvent is added to the X11 event queue when the routine is completed. 

XIE Events and Error Messages

Protocol Messages: X_ieCrop

XIE event returned: XieK_ComputationEvent if immediate execution and computation events are selected

XieLib errors: None

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources

BadValue -- The IDC does not intersect the source image