Digital

NAME

XieLuminance − This routine extracts the luminance component from a multispectral image and creates a new image. 

C Format

dst_photo_id = XieLuminance(src_id)

C Argument Information

XiePhoto     dst_photo_id;
XiePhoto     src_id;

RETURN VALUES

If the source image is an unbound photomap, the routine returns the identifier of the new photomap 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 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. 

DESCRIPTION

This routine extracts the luminance component from a multispectral image and creates a new image. 

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_ieLuminance

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

BadMatch -- The source image is not constrained or the source image is not multispectral