Digital

NAME

XiePutImageData − This routine transports all image data planes from a client XieImage to a photomap. 

C Format

status = XiePutImageData(img)

C Argument Information

unsigned char  status;
XieImage     img;

RETURN VALUES

The routine returns the status of the image data transport in the status argument. If there is more data to be transported, the return is XieK_StreamMore. If all image data has been transported, the return is XieK_StreamFinal. 

PARAMETERS

imgThe img argument specifies the address of the client source XieImage. 

DESCRIPTION

This routine transports all image data planes from a client XieImage to a photomap. You can use this routine only if you created the destination photomap, photoflo, phototap using the XiePutImage routine.  Depending on the quantity of image data to be transported, you may have to issue more than 1 call to this routine until the status return is XieK_StreamFinal. This operation always executes immediately, even when the destination image is a photoflo. 

XIE Events and Error Messages

Protocol Messages: 1 or more calls to X_iePutStream

XIE event returned: None

XieLib errors: XieStreamError for invalid destination image

XieServer errors: BadIDChoice -- Invalid identifier