Digital

NAME

XieFill − This routine creates a new image by filling a region of a source image with a constant. 

C Format

dst_photo_id = XieFill(src_id, idc_id, fill)

C Argument Information

XiePhoto     dst_photo_id;
XiePhoto     src_id;
XieResource   idc_id;
unsigned long  ∗fill;

RETURN VALUES

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

PARAMETERS

src_idThe src_id argument specifies the source image you want to copy and fill. 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 CPP or ROI that defines the region you want to fill.  If you specify a value of 0, the entire source image is copied and filled. 

fillThe fill argument specifies the address of an array of constants used as pixel values in the fill region for each component.  The array must specify 1 constant per component in the destination image.  For example, you could define array entries to be fill[0]=pixel_value, fill[1]=pixel_value, and fill[2]=pixel_value.  If you specify a value of null, the routine uses a default constant value that fills the region with a maximum intensity (white) pixel value. 

DESCRIPTION

This routine creates a new image by filling a region of a source image with a constant. 

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

XIE Events and Error Messages

Protocol Messages: X_ieFill and X_ieQueryResource if the fill argument is null

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

XieLib errors: Returns null if the fill array is null and the source image is invalid

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources

BadValue -- The IDC does not intersect the source image