Digital

NAME

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

C Format

XieGetTile(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 the source photomap. 

imgThe img argument specifies the address of an existing XieImage data structure. 

p_maskThe p_mask argument specifies a mask that identifies the planes you want to transport. The least significant bit of the mask corresponds to plane 0. You can specify the symbol XieK_AllPlanes to transport all planes. 

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

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

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

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

widthThe width argument specifies the width in pixels of the source photomap tile you want to transport. 

heightThe height argument specifies the height in scanlines of the source photomap tile you want to transport. 

DESCRIPTION

This routine transports a tile of uncompressed image data from a server photomap to a client XieImage. You cannot use this routine from a photoflo and the source photomap cannot be bound to a photoflo. 

XIE Events and Error Messages

Protocol Messages: X_ieSetTransport

1 or more calls to X_ieGetTile

XIE event returned: None

Lib errors: Reply error, BadLength

XieServer errors: BadIDChoice -- Invalid identifier

BadAlloc -- Insufficient server resources

BadValue -- The resulting height or width is less than or equal to 0