Digital

NAME

XieChromeSep − This routine separates 1 chrominance component from a multispectral source image and creates a new image containing the separated component. 

C Format

dst_photo_id = XieChromeSep(src_id, component)

C Argument Information

XiePhoto     dst_photo_id;
XiePhoto     src_id;
unsigned long   component;

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 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 phototap or a photomap bound to the photoflo. 

componentThe component argument specifies the chrominance component you want to separate. Specify a value of 0, 1, or 2. 

DESCRIPTION

This routine separates 1 chrominance component from a multispectral source image and creates a new image containing the separated component. 

The source image component organization must be multispectral and can be constrained or unconstrained. The output image is either constrained or unconstrained, depending on the source image. 

If the operation is performed immediately and you have 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_ieChromeSep

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 specified component is not 0, 1, or 2

BadMatch -- The source image is not multispectral