XiePutImage(3X) — Subroutines
Digital
NAME
XiePutImage − This routine creates a photoflo or photomap, and optionally transports XieImage data to the photoflo or photomap.
C Format
photo_id = XiePutImage(dpy, img, mode)
C Argument Information
XiePhoto photo_id;
Display ∗dpy;
XieImage img;
unsigned char mode;
RETURN VALUES
If you specify the symbol XieK_DataFlo for the mode argument, the routine returns the photoflo identifier in the photo_id argument. Otherwise, the routine returns the new photomap identifier. You can free the photomap using the XieFreeResource routine.
PARAMETERS
dpyThe dpy argument specifies the X11 display identifier returned by the XOpenDisplay routine.
imgThe img argument specifies the address of an existing client XieImage structure.
modeThe mode argument specifies an image data transport option.
| Symbol | Status of Image Data in the New Photomap |
| XieK_DataFlo | Create photoflo and SetStream for put data |
| XieK_DataMap | Create photomap and SetStream for put data |
| XieK_DataNone | Create photomap without transporting image data |
| XieK_DataCopy | Create photomap and transport all planes of image data |
DESCRIPTION
This routine creates a photoflo or photomap, and optionally transports all XieImage data planes to the photoflo or photomap.
XIE Events and Error Messages
Protocol Messages: X_ieCreateResource
X_ieSetTransport for the mode symbols XieK_DataFlo, XieK_DataMap, and XieK_DataCopy
1 or more calls per data plane to X_iePutStream for the mode symbol XieK_DataCopy
XIE event returned: None
XieLib errors: Fatal, invalid mode argument
XieServer errors: BadAlloc -- Insufficient server resources
BadIDChoice -- Invalid identifier