Digital

NAME

XieChromeCom − This routine creates a multispectral image by combining the 3 chrominance components of existing images. 

C Format

dst_photo_id = XieChromeCom(src_id1, src_id2, src_id3)

C Argument Information

XiePhoto     dst_photo_id;
XiePhoto     src_id1;
XiePhoto     src_id2;
XiePhoto     src_id3;

RETURN VALUES

If the 3 source images are all unbound photomaps, 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_id1
  The src_id1 argument specifies the identifier of the source image that provides the red component.  If you are using this routine outside the context of a photoflo, you must specify an unbound photomap.  If you are using this routine within the context a photoflo, the source image can be a photoflo, or a photomap or phototap bound to the photoflo. 

If you specify an unbound photomap, the operation is performed immediately.  Otherwise, a processing element is appended to the 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. 

src_id2The src_id2 argument specifies the identifier of the source image that provides the green component.  If you are using this routine outside the context of a photoflo, you must specify an unbound photomap.  If you are using this routine within the context a photoflo, the source image can be a photoflo, or a photomap or phototap bound to the photoflo. 

If you specify an unbound photomap, the operation is performed immediately.  Otherwise, a processing element is appended to the 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. 

src_id3The src_id3 argument specifies the identifier of the source image that provides the blue component.  If you are using this routine outside the context of a photoflo, you must specify an unbound photomap.  If you are using this routine within the context a photoflo, the source image can be a photoflo, or a photomap or phototap bound to the photoflo. 

If you specify an unbound photomap, the operation is performed immediately.  Otherwise, a processing element is appended to the 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. 

DESCRIPTION

This routine creates a multispectral image by combining the 3 chrominance components of existing images.  The source images must be either all constrained or all be unconstrained.  The output photomap is either constrained or unconstrained, depending on the source images. 

The routine assumes the source images to be spatially aligned at the upper left corner. If the source images are of different sizes, the routine calculates the size of the combined image to be the intersection of the source images. 

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_ieChromeCom

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

BadAccess -- 1 source image is a photoflo and the others are not bound to it

BadMatch -- A source image has multiple components or the source images are not all constrained or all unconstrained.