Digital

NAME

XiePutTile − This routine transports a tile of uncompressed image data from a client XieImage to a server image. 

C Format

XiePutTile(phm_id, img, p_mask, src_x, src_y, dst_x, dst_y, width, height)

C Argument Information

XiePhotomap   phm_id;
XieImage     img;
unsigned long  p_mask;
long       src_x;
long       src_y;
long       dst_x;
long       dst_y;
unsigned long  width;
unsigned long  height;

RETURN VALUES

None. 

PARAMETERS

phm_idThe phm_id argument specifies the identifier of an unbound photomap. 

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

p_maskThe p_mask argument specifies a mask that defines which planes of the source image you want to transport. The least significant bit indicates plane 0. You can specify the symbol XieK_AllPlanes to transport all of the source image data planes. 

src_xThe src_x argument specifies the x-coordinate of the upper left hand corner of the tile you want to transport. 

src_yThe src_y argument specifies the y-coordinate of the upper left hand corner of the tile you want to transport. 

dst_xThe dst_x argument specifies the x-coordinate of the upper left hand corner of the tile in the destination photomap. 

dst_yThe dst_y argument specifies the y-coordinate of the upper left hand corner of the tile in the destination photomap. 

widthThe width argument specifies the width of the tile you want to transport. 

heightThe height argument specifies the height of the tile you want to transport. 

DESCRIPTION

This routine transports a tile of uncompressed image data from a client XieImage to a server image. You cannot use this routine to transport image data to a photoflo or to any photomap bound to a photoflo. 

If you use this routine to modify the image data of a photomap that you previously exported to a dynamic visual class X11 drawable, the ExportContext can be incompatible with the photomap image data. Use the XieQueryExport and the XieFreeExport routines to resolve such conflicts. 

XIE Events and Error Messages

Protocol Messages: X_ieSetTransport

1 or more calls to X_iePutTile

XIE event returned: None

XieLib errors: None

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources

BadValue -- Height or width is less than or equal to 0