XieCopyImage(3X) — Subroutines
Digital
NAME
XieCopyImage − This routine creates a client XieImage by copying an existing XieImage.
C Format
dst_image = XieCopyImage(img, mode)
C Argument Information
XieImage dst_image;
XieImage img;
unsigned char mode;
RETURN VALUES
The routine returns the identifier of the newly created image in the dst_image argument. You can free the image using the XieFreeImage routine.
PARAMETERS
imgThe img argument specifies the pointer to the XieImageRec you want to copy.
modeThe mode argument specifies the status of image data in the new XieImage.
| Symbol | Status of Image Data in the New XieImage |
| XieK_DataNone | Image data pointers = null |
| XieK_DataAlloc | Allocate new image buffers containing no data |
| XieK_DataCopy | Allocate new image buffers and copy data |
| XieK_DataShare | Copy pointers to existing image data |
DESCRIPTION
This routine creates a client XieImage by copying an existing XieImage.
XIE Events and Error Messages
Protocol Messages: None
XIE event returned: None
XieLib errors: Fatal, invalid mode argument
XieServer errors: None