Digital

NAME

XiePoint − This routine creates a new photomap by remapping each pixel value to a new value that is independent of neighboring pixel values. 

C Format

dst_photo_id = XiePoint(src_id, idc_id, tbl_id)

C Argument Information

XiePhoto   dst_photo_id;
XiePhoto   src_id;
XieIdc    idc_id;
XiePhoto   tbl_id;

RETURN VALUES

If the source image is an unbound photomap, the routine returns the identifier of the remapped 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 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. The source image can be either bitonal, gray scale, or multispectral and must be constrained. 

idc_idThe idc_id argument specifies the optional CPP or ROI that defines the region of the source image over which the routine operates. If you specify a value of 0, the routine operates over the entire image. 

tbl_idThe tbl_id argument specifies the identifier of the photomap the routine uses as a LUT to remap the source image pixels. If the source image identifier is a photoflo, the LUT must be bound to the photoflo using the XieBindMapToFlo routine. 

You must structure the LUT to have the same number of components that you want in the remapped image. Each component must contain a single scanline, which must contain as many unique pixel values as there are different levels in the corresponding component of the source image.  If the source photomap is multispectral, the LUT must contain 3 components. If the source photomap is bitonal or gray scale, the LUT can contain either 1 or 3 components, depending on the type of remapping you want to perform. If the source photomap is bitonal or gray scale, the same source pixels are remapped into as many spectral components as there are components in the LUT. 

DESCRIPTION

This routine creates a new photomap by remapping each pixel value to a new value that is independent of neighboring pixel values. 

On a per-component basis, the routine uses each pixel value in the source image as an index into the LUT to obtain a new value for that pixel. If the number of components in the LUT is greater than the number of components in the source image, the routine reuses the last component in the source image to remap into the last component in the output image. This allows you to convert gray scale images to pseudocolor images using the appropriate choice of LUTs. 

The output photomap has the same spatial dimensions as the source image. The routine operates over the area defined by the IDC, if you specify 1. Otherwise, the routine operates over the entire source image. Pixel values outside the area of the IDC retain their original values. 

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_iePoint

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 and the LUT photomap are not constrained

BadAccess -- The source image is a photoflo and the LUT photomap is not bound to it

BadValue -- IDC does not intersect the source image